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1.0 Introduction 


XASMl^■8 is a cross-assembler designed to run on 8080- and 
Z80-based microcomputers, tinder the CP/M* operating system. 
It generates machine code for the Intel 80^8 family of 
microprocessors, accepting standard 80^8 mnemonics and 
syntax. 

The 80it8 family includes five different processor groups, as 
distinguished by slightly different instruction sets; these 
are represented by the 80U8, 80ltlA, 80hl, 8022, and 8021 
chips. Within each group, various models provide a 
selection of memory and input/output configurations. XASMJ+8 
assembles instructions for all five groups, and has 
provisions for flagging instructions not available in a 
specified target machine. 

XASMl;8 accepts its input from a CP/M text file, and 
generates as output an object code file, an assembly 
listing, and an alphabetized listing of all symbols defined 
in the assembly. The object file may be in Intel HEX format 
or may be omitted altogether, at the user's discretion. The 
listings are normally sent to the system's LIST device, but 
may be directed to the console or to a disk file. 

The assembler features a variety of pseudo-operations. In 
addition to the usual storage-definition instructions, there 
are facilities for conditional assembly, for control of 
listing format, and for including multiple source files in 
an assembly. New mnemonics may be defined as synonyms for 
existing operations and pseudo-operations, thus easing the 
task of converting existing programs. 


*Trademark of Digital Research. 
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This document is intended as a reference manual for the 
experienced user. As such, it assumes familiarity with the 
801^8 instruction set, with the operation of CP/M, and with 
assemblers in general. Users lacking this background 
information may obtain it from the CP/M manuals and from the 


references listed below: 

MCS-lt8 USER’S MAKUAL 

UPI-l^l USER'S MANUAL 

UPI-lHA USER'S MANUAL 

MCS-1+8 AND UPI-J+1 
ASSEMBLY LANGUAGE MANUAL 


Intel Corp. 

No. 9800270 

Intel Corp. 

No. 9800504 

Intel Corp. 

No. 9800504-02 

Intel Corp. 

No. 9800255 



XASMI^8 User's Manual 


Page 3 


2.0 RiiTiTilTig “the Cross~Assembler 


2.1 XASM^tS Command Strings 

The 801+8 cross-assembler is invoked by typing 

XASMl+8 [d: ] filename! .ext] [d:] [switches] 

The d:'s are optional drive specifiers (eg. A:, B:, etc.). 
The file extension (.ext) is also optional; if omitted, it 
defaults to .ASM. The second d: specifies a disk drive for 
the output files (object and listing); if it is omitted, 
these files are placed on the currently-logged drive. The 
switches are (optional) single characters which control the 
output of the assembler, as described below. 


2.2 XASMl+8 Switches 

The switches following the filename, if supplied, control 
various options as follows: 

L Listing only; ie. no object file. 

X No assembly listing. 

Y No symbol-table listing 

0 Object only; equivalent to XY. 

C Send listing, if any, to console instead of 1ST: 
device. 

D Send listing, if any, to disk file with same name 
as source file and extension "PRN". 

N Suppress pagination of assembly listing; ie. no 
page headings or page ejects. 
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Base k 


The switches may he vised in comhination; for example, 

XASMI18 GRINCH YC 

will suppress the symbol-table listing and send the assembly 
listing to the console. Note that errors are always listed, 
even if listing is turned off. Thus, 

XASMI18 GRINCH LXYC 

will list errors only, on the console. 


2.3 S iumuary of Defaults 

The default output options, in the absence of their 
respective specifiers, are as follows: 

The source file is assumed to have extension "ASM" 
and to reside on the currently- logged drive. 

An object file is generated. It is in Intel HEX 
format and is placed on the currently-logged 
drive. 

An assembly listing and a symbol-table listing are 
generated; they are sent to the CP/M LST: device. 
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3.0 Syntax of Assembler Source Files 


3.1 Statements 

Source files consist of a sequence of statements of one of 
the forms: 

[label:] operator [arguments] [; comment] 

symbol operator [arguments] [jcomment] 

[ ;comment ] 

If a label or a leading symbol is present, it must begin in 
column 1. Labels must be followed by a colon. Blank lines 
are treated as comments. Elements of a statement may be 
separated by blanks or tabs. 


3.2 S ymbols 

Symbols may be up to 8 characters in length, may include 
any of the following characters: 

A..Z 0..9 $ . 

The first character of a symbol must be a letter or a period. 


3.3 Bfumerlc Constants 

Numeric constants consist of a sequence of digits, 
optionally proceeded or followed by a radix specifier. The 
first character must be either a leading radix specifier or 
a decimal digit (0..9). The default radix is ten. For 
compatiblity with existing assemblers, other bases may be 
denoted by either a leading or a trailing specifier. The 
leading radix specifiers are: 

% (binary) § (octal) $ (hex) 

The trailing specifiers are: 

B (binary) Q (octal) H (hex) 
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Thxis, for exeimple, the following are equivalent: 
^lllllll lllllllB §17T 177Q $7F 7FH 


3.^ Character Constants 

Character constants may he used wherever a numeric value is 
allowed. A character constant consists of one or two 
characters enclosed in single or double quotes (' or "). 
The single quote may be used as a character between double 
quotes, and vice-versa. 

Thus, the following are equivalent: 

’A’ "A" and ItlH 

•AB’ "AB" and l+llt2H 

3.5 Location-Counter Reference 

The character *'$" may be used as an element in expressions. 
Its value is the value of the location counter at the 
beginning of the current statement. 



Arithmetic expressions are composed of symbols, numeric 
constants, character constants, and operators. All operators 
except +, -, *, and / must be separated from their operands 
by at least one space. Symbols which are operators are 
reserved, and may not be redefined as user symbols. 

A description of the operators follows : 
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3.61 Arlthnietlc Operatoirs 

These treat their operands as l6-hit unsigned quantities, 
and return l6-hit results. No overflow checking is 


performed. 


+ and - 

Sum and Difference. Operands and results 
may he thought of as unsigned or as twos- 
complement quantities. 

unary + 

+x is defined as 0+x 

unary - 

-X is defined as 0-x 

* / 

Product and Quotient (unsigned) 

MOD 

Remainder ; 

X MOD y gives the remainder of x/y 


3 . 62 Shift Operators 

SHL Binary left shift, x SHL y yields x shifted 

left y places (ie. x multiplied hy 2**y). 

SHR Binary right shift, logical, x SHE y yields 

X shifted right y places (ie. x divided hy 
2**y) . 

If the right argument is negative, then the direction of the 
shift is reversed. 


3.63 Byte-Extraction Operators 

HIGH Returns the value of the most significant hyte of 

its argument. 

LOW Returns the value of the least significant hyte 

of its argument 

These are xmary operators, taking an argument on the right. 
For example; HIGH 1122H is IIH, and LOW 1122H is 22H. 
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3.61+ Boolean Operators 

NOT Unary logical negation. Complements all the bits 

in its argument. 

AND Logical product; ie. each bit of the result is 

obtained by ANDing together the corresponding 
bits in the arguments. 

OR Logical sum. 

XOR Exclusive-OR. 

These are all bitwise operators; that is, the same operation 

is performed on each operand bit position, with no carry 

from one bit position to the next. 

For example: NOT 0 is OFFFFH 

lOlB AND OlOB is 0 
lOlB OR OlOB is lllB 
lOlB XOR OlOB is lllB 
lOlB XOR lOOB is OOIB 


3.65 Relational Operators 

These perform unsigned l6-bit comparisons of their operands, 
retiirning 1 for TRUE and 0 for FALSE. 

For comparison x R y, where R is a relational operator, the 
results are as follows: 

EQ TRUE iff X and y are equal 

NE TRUE iff X and y are not eq\ial 

LE TRUE iff X is less than or equal to y 

LT TRUE iff X is strictly less than y 

GE TRUE iff X is greater than or equal to y 

GT TRUE iff X is strictly greater than y. 
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3 . 66 Evaluation of Kirgesslons 

Parentheses may be used to specify the order of eval\iation 
of subexpressions. In the absence of parentheses, this 
order is determined by operator precedence; higher- 
precedence operators are evaluated first. In the case of 
operators vith equal precedence, evaluation proceeds from 
left to right. The operators are listed below in groups 
according to precedence. Operators in the same horizontal 
group have the same precedence; 


unary +, xmary - (HIGHEST PRECEDENCE) 

HIGH LOW 

* / MOD SHE SHL 

+ - 

EQ NE LT LE GT GE 

NOT 

AND 

OR XOR (LOWEST PRECEDENCE) 
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U.O Instruction Set Idlosyncracles 


While the 80^8 family instruction set is not discussed in 
detail in this manual, some peculiarities of the jump and 
call instructions are vorthy of note; 

The JMP and CALL instructions in machine code contain a 
target address of 11 hits; a 12th bit is supplied via the 
memory bank selection feature. In the assembler, 12-bit 
addresses are accepted as operands for these instructions, 
but the high-order bit is. discarded. Range checking is 
performed to ascertain that the target address is less than 
or equal to 1*095. 

Ho JMP instruction may begin at location 20UT or at 1*095. 
No CALL instruction may begin at 20U6, 20l*7, l*09l*, or 1*095- 

The short jump instructions (including DJNZ) contain a 
single byte operand representing an address vithin the 
current 256-byte page. The assembler accepts addresses in 
the range 0.. 1*095 as operands for these instructions. Bits 
8 thru 11 are discarded vhen assembling the instruction, but 
are compared vith the corresponding bits of the location 
counter to make sure the target address is accessible. If a 
short jump begins at the last location of a page (ie. lov 
order address byte is 255) then its operand must lie in the 
following page; this is enforced by the assembler. 
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5.0 Pseudo-Operations 


5.1 Storage Definition 
DB arg[ ,arg. . . ] 

Define Dytes. Each arg may he either an expression or 
a string. Expressions must evaluate to 8-hit values 
(high byte either 0 or 255). Strings may he delimited 
hy single or double quotes, as for character constants. 

For each expression, a single byte of storage is 
reserved, initialized to the low byte of the 
expression's value. For each string, the characters of 
the string are stored in sequential reserved bytes. 

If a compound expression beginning with a character 
constant is used in a DB, then the expression must be 
enclosed in parentheses to keep it from being 
incorrectly parsed as a string. For example, 

DB Ca'+I) 

will give the expected result, while 
DB 'A'+l 

would be in error. 


DW expresslont , expression. .. ] 

Each expression reserves one word (2 bytes), 
initialized to the value of the expression. The value 
is placed in memory with the high“Order byte first. 


DS expression 

Reserves n tytes, where n is the value of the 
expression. The bytes are not initialized. 
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5.2 ORG and KHD 


ORG expression 

Set program origin. This statement should precede the 
first code-generating statement in the source file. It 
sets the program counter initial value to the value of 
the expression, thus setting the location of code which 
follows. Additional ORG statements may be used to 
generate program segments which will load at different 
locations . 

END [expression] 

The last statement of the source file must be an END 
statement. An optional argument is allowed; if this is 
supplied, its value becomes the start address specified 
in the last record of the HEX object file. 


5.3 Symbol Definition 
EQU and SET 


These take the form: 

symbol EQU expression 
symbol SET expression 

They cause the symbol to be defined and given the value 
of the argument expression. Symbols defined with EQU 
serve as symbolic constants, and may not have their 
values changed. Symbols defined with SET are treated 
as variables; their values may be changed by additional 
SET's. 
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5. It Conditional Assembly 
IF, ELSE, and EKDIF 

The construct 

IF expression 
statement 


ENDIF 

behaves as follows; If the value of the expression is non- 
zero, then the statements between the IF and the ENDIF are 
assembled. Otherwise, these statements are ignored. 
Similarly, 

IF expression 
statement 


ELSE 

statement 


ENDIF 

causes the first sequence of statements to be processed if 
the expression is TRUE (non-zero), and the second sequence 
to be processed otherwise. 

Conditionals may be nested to a depth of 10. The value of 
the expression in the IF statement must be known in Pass 1. 
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5.5 Listing Control 


PA(S [expression] 

If the argument is omitted, then this causes an 
immediate page eject (ie. a skip to the top of the next 
page). If an argument is supplied and has value n, 
then an eject occurs only if there are less than n 
lines remaining on the cvirrent page. 


WIDTH expression 

Sets the assumed width of the listing page. The value 
of the argument may he between 32 and 132, and defaults 
to 132. 


PGIHI expression 

Sets the number of lines which will be printed on each 
page of the listing. Note that the page heading takes 
up 7 of these lines. The value of the argument may be 
between 8 and 255, and defaults to 58. 


TITIE dtextd 

Causes the specified text to become the listing page 
title, beginning with the next page header printed. 
The delimiter d may be any printing character. 

If no TITLE statement is used, then XASMli8 supplies a 
default title consisting of the text "SOURCE FILE 
NAME: " followed by the name and extension of the input 
file. 


SBTTL dtextd 

Just like TITLE, but sets the listing page subtitle, 
which is printed on the line after the title line. 
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LIST and HOUST 

These allow selective listing of portions of a program. 
NOLIST turns off the assembly listing, and LIST turns 
it hack on. If listing has been turned off with 
HOLIST, then the next LIST encoimtered will begin a new 
page. Command-line switches which disable listing (ie. 
X and O) will take precedence over LIST. NOLIST does 
not turn off listing of the symbol table. 


5.6 Ertemal Source Files 
INCLQD drname.ext 

This pseudo-op causes the specified file to be included 
as if it were present at this point in the soxxrce file. 
INCLUD's may not be nested; that is, the file read by 
INCLUD may not contain another INCLUD statement. The 
file must end with an END statement. 


5.7 Operator Synonyms 
The statement 

symbol OPSYN operator 

causes the given symbol to be defined as a synonym for the 
operator or pseudo-op specified as argument. This is 
particularly useful when assembling source files written for 
another assembler. For example, if a program uses .BYTE 
instead of DB, it could be correctly assembled by including 
the statement 

.BYTE OPSYN DB 
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5.8 Target Machine Validation 

XASMl+S checks to see that each instruction assemhled is in 
the target machine's instruction set. The default target 
instruction set is that of the 8 OU 8 . Others may he 
specified by one of the folloving pseudo-ops: 

modUia 

modUi 

M0D22 

M0D21 

Only one of these may appear in a given program; it may only 
appear once, and it must precede all code-generating 
instructions . 

The instruction sets for the five machine groups are listed 
in appendices C and D. 
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6.0 Errors 


Fatal errors result in the printing of an error message on 
the console and immediate ret\irn to CP/M. Fatal errors may 
be cavised by missing source files, inadequate disk space for 
output files, or overflow of the symbol table or various 
internal stacks. 

Non-fatal errors are flagged with a character in the first 
column of the assembly listing. Lines containing errors are 
always listed, even if listing is turned off. A count is 
maintained of lines containing errors; if the coiint is non- 
zero at the end of the assembly, it is printed on the 
console in the message: 

***** nnn LINES CONTAINED ERRORS ***** 


Only one error is listed per line; hence, if a line contains 
multiple errors some may not be caught until successive 
assembler rrms. 

The fatal error messages and non-fatal error flags are 
described in Appendix A. 
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Format of Listings 


7.1 Beige Headings 

All listings begin with a heading consisting of seven lines: 

(blank line) 

(blank line) 

(assembler name and version) 

(blank line) 

(title and page number) 

(subtitle) 

(blank line) 


If no title is supplied in the source program, then the 
assembler provides a default title consisting of the message 

SOURCE FILE NAME: 

followed by the name of the input file in the form name.ext. 
The page number is listed at the right-hand end of this same 
line, always within the specified page width. 


If no subtitle is supplied, the subtitle line is left blank. 
Both title and subtitle will be trtmcated, if necessary, to 
satisfy page width constraints. 


7.2 Line Headings 

Each code-generating line of the listing begins with the 
error flag (blank if no error) and the It-digit hexadecimal 
value of the location counter as of the start of the line. 
This is foUowed by up to four bytes of generated code, also 
in hexadecimal with two digits per byte. Statements which 
generate more than 4 bytes will be assembled correctly, but 
only the first four bytes are listed. Lines which do not 
generate code but which evaluate an oi)erand (such as EQU or 
WIDTH) list the operand value in their headers, in place of 
the location counter. 
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7.3 Symbol-Table Listing 

The symbol-table listing shows all symbols defined in the 
ciirrent assembly, with their hexadecimal values. Only user- 
defined symbols are listed. Symbols are in vertical 
columns, sorted alphabetically according to the ASCII 
collating sequence. The number of columns is adjusted 
automatically to fit in the specified page width. All pages 
of the symbol-table listing are automatically subtitled 

SYMBOL TABLE 


Because the sorting scheme "alphabetizes” symbol names even 
if they end in nximeric characters, the listing order may not 
be what you expect. For example, a typical sequence of 
symbols might appear as follows: 

SYM19 

SYM2 

SYM20 

SYM21 

SYM3 

SYMl* 
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APPElfDIX A. Error Messages and Flagg 


Hon-Fatal Error Flags 

C Conditional Err Unmatched IF, EI£E, or ENDIF; or 

conditionals nested too deep. 

I INCLUD Err File not found, or nested IHCLUD's. 

J Jtunp Err A jump or call instruction begins too 

near the end of a 2K page. Jumps and 
DJNZ may not begin at locations 20UT or 
it095. CALL may not begin at locations 
201+6, 201+7, 1*091+, or 1+095. 

L Label Err Label too long. ( >8 chars) 

M Multiple Defn Symbol already defined. 

0 Operator Err Undefined or illegal operator. 

P Phase Err Symbol had different value on Pass 2 

than on Pass 1. 

R Range Err Argument out of bounds, branch out of 

range, or illegal register /port number. 

S Syntax Err Ill-formed argument or expression. 

U Undefined Undefined symbol(s) in operand field'. 

Instruction not available on specified 
target machine. 


W Warning 
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P^tel Error Messages 


SOUECE FILE NOT POUND 

UNABLE TO CREATE OUTPUT FILE 

OUTPUT FILE WRITE ERROR 
EVALUATION STACK FULL 

SYMBOL TABLE FULL 

- NoP-^tal Error Messages 

NO ROOM FOR SYMBOL-TABLE SORT 

END STATEMENT MISSING 


The si)ecified source file 
doesn't exist. 

The directory is full on the 
disk s pec i fed for output. 

The output disk is full. 

An arithmetic expression was 
encountered which had too many 
levels of parentheses or of 
precedence nesting. 

Not enough memory remains to 
create a table entry for a 
symbol being defin^. 


Not enough memory is available 
to sort the symbol table. 
Symbol-table listing is 
therefore omitted. 

End-of-File was reached in the 
source file, or in an include 
file, without encountering an 
END statement. The assembler 
inserts an END statement, 
flagged by a string of asterisks 
in the comment field. 
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APPEBDIX B. Ob.lect File Formt 


Object files are in the Intel HEX format, which represents binary 
data tytes as two-digit ASCII hexadecimal numbers. An object 
file consists of a sequence of data records, followed by a single 
end record. 


The record formats are: 


Data Record: 


Byte 1 

2. . 3 

6 . . 7 

8 . . 9 

10. .X 
x+1 . . x+2 
x+3 . . x+li^ 


Colon ( : ) 

Number of binary data bytes in this record. 
Load address for this record, high byte. 
Load address, '' '' '* low byte. 

Unused, shoTild be "OO”. 

Data bytes, two characters each. 

Checksum (2 characters). 

CR/LF 


End Record : 

Like data record, but ntimber of data bytes is zero and the 
load address field contains the program starting address. 


The checksxim is the two's complement of the 8~bit sum, 
without carry, of all the data bytes, the two bytes of load 
address, and the byte count. 
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APPEHDIX C. Si iuiuai T Of Instruction Sets 


Mnemonic 


801^8 

80L1A 

80U1 

8022 

8021 

ADD 

A,#data 


X 

X 

X 

X 

X 

ADD 

A,Rr 

• 

• 

o 

II 

X 

X 

X 

X 

X 

ADD 

A,gRr 

( r=0 . , 1 ) 

X 

X 

X 

X 

X 

ADDC 

A,#data 


X 

X 

X 

X 

X 

ADDC 

A,Rr 

(r=0..T) 

X 

X 

X 

X 

X 

ADDC 

A,@Rr 

(r=0. .1) 

X 

X 

X 

X 

X 

ANL 

A,#data 


X 

X 

X 

X 

X 

ANL 

A,Rr 

• 

• 

o 

II 

u 

X 

X 

X 

X 

X 

ANL 

A,@Rr 

(r=0. .1) 

X 

X 

X 

X 

X 

ANL 

BUS,#data 


X 





ANL 

Pp,#data 

(p=1..2) 

X 

X 

X 



ANLD 

Pp,A 

(p=lt..T) 

X 

X 

X 

X 

X 

CALL 

addr 


X 

X 

X 

X 

X 

CLR 

A 


X 

X 

X 

X 

X 

CLR 

C 


X 

X 

X 

X 

X 

CLR 

FO 


X 

X 

X 



CLR 

FI 


X 

X 

X 



CPL 

A 


X 

X 

X 

X 

X 

CPL 

C 


X 

X 

X 

X 

X 

CPL 

FO 


X 

X 

X 



CPL 

FI 


X 

X 

X 



DA 

A 


X 

X 

X 

X 

X 
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Mnemonic 


80l^8 

80l*lA 

801+1 

8022 

8021 

DEC 

A 


X 

X 

X 

X 

X 

DEC 

Rr 

11 

o 

• 

• 

X 

X 

X 



DIS 

I 


X 

X 

X 

X 


DIS 

TCNTI 


X 

X 

X 

X 


DJNZ 

Rr,addr 

• 

• 

o 

11 

X 

X 

X 

X 

X 

EN 

DMA 



X 




EN 

FLAGS 



X 




EN 

I 


X 

X 

X 

X 


EN 

TCNTI 


X 

X 

X 

X 


ENTO 

CLK 


X 





IN 

A,DBB 



X 

X 



IN 

A,PO 





X 

X 

IN 

A,Pp 

CVJ 

• 

• 

H 

h 

X 

X 

X 

X 

X 

INC 

A 


X 

X 

X 

X 

X 

INC 

Rr 

• 

• 

o 

II 

u 

X 

X 

X 

X 

X 

INC 

§Rr 

II 

o 

• 

• 

H 

X 

X 

X 

X 

X 

INS 

A, BUS 


X 





JBb 

addr 

(b=0..7) 

X 

X 

X 



JC 

addr 


X 

X 

X 

X 

X 

JFO 

addr 


X 

X 

X 



JFl 

addr 


X 

X 

X 



JMP 

addr 


X 

X 

X 

X 

X 

JMPP 

§A 


X 

X 

X 

X 

X 

JNC 

addr 


X 

X 

X 

X 

X 
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Mnemonic 


80U8 

80U1A 

801I1 

8022 

8021 

JNI 

addr 


X 





JUIBF 

addr 



X 

X 



J1?T0 

addr 


X 

X 

X 

X 


JNTl 

addr 


X 

X 

X 

X 

X 

JBZ 

addr 


X 

X 

X 

X 

X 

JOBF 

addr 



X 

X 



JTF 

addr 


X 

X 

X 

X 

X 

JTO 

addr 


X 

X 

X 

X 


JTl 

addr 


X 

X 

X 

X 

X 

JZ 

addr 


X 

X 

X 

X 

X 

MOV 

A,#data 


X 

X 

X 

X 

X 

MOV 

A,PSW 


X 

X 

X 



MOV 

A,Rr 

it 

O 

• 

• 

--4 

X 

X 

X 

X 

X 

MOV 

A,§Rr 

II 

O 

• 

• 

H 

X 

X 

X 

X 

X 

MOV 

A,T 


X 

X 

X 

X 

X 

MOV 

PSW,A 


X 

X 

X 



MOV 

Rr,A 

H 

11 

O 

• 

• 

X 

X 

X 

X 

X 

MOV 

Rr,#data 

(r=0..7) 

X 

X 

X 

X 

X 

MOV 

§Rr,A 

II 

o 

• 

• 

X 

X 

X 

X 

X 

MOV 

@Rr,#data (r=0..l) 

X 

X 

X 

X 

X 

MOV 

STS, A 



X 




MOV 

T,A 


X 

X 

X 

X 

X 

MOVD 

A,Pp 

(p=lt..T) 

X 

X 

X 

X 

X 

MOVD 

Pp,A 

(p=i^..7) 

X 

X 

X 

X 

X 
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P&ge C-U 


Mnemonic 


801+8 

801+ lA 

801+1 

8022 

8021 

MOVP 

A,@A 


X 

X 

X 

X 

X 

MOVP3 A,§A 


X 

X 

X 



MOVX 

A,@Rr 

(r=0. .1) 

X 





MOVX 

SRr,A 

(r=0..l) 

X 





NOP 



X 

X 

X 

X 

X 

ORL 

A,#data 


X 

X 

X 

X 

X 

ORL 

A,Rr 

(r=O..T) 

X 

X 

X 

X 

X 

ORL 

A,§Rr 

ii 

O 

• 

• 

H 

X 

X 

X 

X 

X 

ORL 

BUS,#data 


X 





ORL 

Pp, #data 

(p=1..2) 

X 

X 

X 



ORLD 

Pp.A 

(P=l+..7) 

X 

X 

X 

X 

X 

OUT 

DBB,A 



X 

X 



OUTL 

BUS, A 


X 





OUTL 

PO,A 





X 

X 

OUTL 

Pp,A 

(p=1..2) 

X 

X 

X 

X 

X 

RAD 






X 


RET 



X 

X 

X 

X 

■ X 

RETI 






X 


RETR 



X 

X 

X 



RL 

A 


X 

X 

X 

X 

X 

RLC 

A 


X 

X 

X 

X 

X 

RR 

A 


X 

X 

X 

X 

X 

RRC 

A 


X 

X 

X 

X 

X 


SEL MO 


X 
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Mnemonic 


QOkQ 

eoiiiA 

80ln 

8022 

8021 

SEL 

ANl 





X 


SEL 

MBO 


X 





SEL 

MBl 


X 





SEL 

RBO 


X 

X 

X 



SEL 

RBI 


X 

X 

X 



STOP 

TCNT 


X 

X 

X 

X 

X 

STRT 

CNT 


X 

X 

X 

X 

X 

STRT 

T 


X 

X 

X 

X 

X 

SWAP 

A 


X 

X 

X 

X 

X 

XCH 

A,Rr 

(r=0..T) 

X 

X 

X 

X 

X 

XCH 

A,@Rr 

li 

O 

• 

• 

H 

X 

X 

X 

X 

X 

XCHD 

A,§Rr 

H 

• 

• 

O 

il 

X 

X 

X 

X 

X 

XRL 

A,#data 


X 

X 

X 

X 

X 

XRL 

A,Rr 

(r=O..T) 

X 

X 

X 

X 

X 

XRL 

A,§Rr 

( r=0 . . 1 ) 

X 

X 

X 

X 

X 
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APPEHDIX D. Instruction Mnemonics and Opcodes 


This is an excerpt from an actual XASM48 assembly listing, 
shoving all of the instruction mnemonics, the available 
addressing modes for each, and the associated hex opcodes. 
Instructions not available on the 80U8 proper have been flagged 
as "W" errors by the assembler. 


0100 

ORG 

lOOH 

0005 

GRINCH EQU 

5 

0100 68 

ADD 

A,R0 

0101 69 

ADD 

A,R1 

0102 6a 

ADD 

A,R2 

0103 6B 

ADD 

A,R3 

010 J+ 6c 

ADD 

A,Rlt 

0105 6d 

ADD 

A,R5 

0106 6e 

ADD 

A,r6 

OlOT 6 f 

ADD 

A,R7 

0108 6o 

ADD 

A,§R0 

0109 6l 

ADD 

A,eRl 

OlOA 0305 

ADD 

A,#GRINCH 

OlOC T8 

ADDC 

A,R0 

OlOD 79 

ADDC 

A,R1 

OlOE TA 

ADDC 

A,R2 

OlOF TB 

ADDC 

A,R3 

0110 TC 

ADDC 

A,Rli 

0111 TD 

ADDC 

A,R5 

0112 TE 

ADDC 

A,R6 

0113 TF 

ADDC 

A,R7 

OllU 70 

ADDC 

A,eR0 

0115 71 

ADDC 

A,eRl 

0116 1305 

ADDC 

A,#GRINCH 

0118 58 

AHL 

A,R0 

0119 59 

ANL 

A,R1 

OllA 5A 

ANL 

A,R2 

OllB 5B 

ANL 

A,R3 

one 5C 

ANL 

A,Rli 

OllD 5D 

ANL 

A,R5 

OllE 5E 

ANL 

A,r6 

OllF 5F 

ANL 

A,R7 
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0120 50 
0121 51 

0122 5305 
012I4 9817 

0126 9905 

0128 9A05 

012A 9C ADDRl: 

012B 9D 
012c 9E 
012D 9F 

012E 3h2A 

0130 27 

0131 97 

0132 85 

0133 A5 

013U 37 

0135 A7 

0136 95 

0137 B5 

0138 57 

0139 07 

013A C8 
013B C9 
013c CA 
013D CB 
013E CC 
013F CD 
OlUO CE 
Olkl CF 

0llt2 15 
OIU3 35 

OlUIt E8l*l4 ADDR2; 

OIU 6 E9itit 

0ll;8 EAl^lt 

OlliA EBltU 

OlltC ECkk 

Oll+E EDkh 

0150 EEl^U 
0152 EFl|l+ 


ANL 

A,eR0 

ANL 

A,eRl 

ANL 

A,ij'GRINCH 

ANL 

BUS,#17H 

ANL 

P1,#GRINCH 

ANL 

P2,#GRINCH 

ANLD 

pi;, A 

ANLD 

P5,A 

ANLD 

P6,A 

ANLD 

P7,A 

CALL 

ADDRl 

CLR 

A 

CLR 

C 

CLR 

FO 

CLR 

FI 

CPL 

A 

CPL 

C 

CPL 

FO 

CPL 

FI 

DA 

A 

DEC 

A 

DEC 

RO 

DEC 

R1 

DEC 

R2 

DEC 

R3 

DEC 

Ri+ 

DEC 

R5 

DEC 

r6 

DEC 

R7 

DIS 

I 

DIS 

TCNTI 

DJNZ 

R0,ADDR2 

DJNZ 

R1,ADDR2 

DJNZ 

R2,ADDR2 

DJNZ 

R3,ADDR2 

DJNZ 

Rl;,ADDR2 

DJNZ 

R5,ADDR2 

DJNZ 

R6,ADDR2 

DJNZ 

R7,ADDR2 


;80U8 only 
;Not in 8021,8022 
;Not in 8021,8022 


;Rot in 8021,8022 
;Not in 8021,8022 


;Not in 8021,8022 
;ltot in 8021,8022 


;Not in 8021,8022 
;Not in 8021,8022 
;Not in 8021,8022 
;Not in 8021,8022 
;Hot in 8021,8022 
;Not in 8021,8022 
jNot in 8021,8022 
;Hot in 8021,8022 

;Hot in 8021 
;Not in 8021 
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P&ge D-3 


W015lt E5 

EH 

mA 

;80l;lA only 

W0155 F5 

EH 

FLAGS 

;80UlA only 

0156 05 

EH 

I 

;Not in 8021 

0157 25 

EH 

TCHTI 


0158 75 

EHTO 

CLK 

;80li8 only 

WO 159 08 

IH 

A,PO 

;8021,8022 only 

015A 09 

IH 

A, PI 


015B OA 

IH 

A,P2 


W015C 22 

IH 

A,DBB 

;8041/1+1A only 

015D 17 

IHC 

A 


015E 18 

IHC 

RO 


015F 19 

IHC 

R1 


0160 LA 

IHC 

R2 


0161 IB 

IHC 

R3 


0162 1C 

IHC 

RU 


0163 ID 

IHC 

R5 


0l61t IE 

IHC 

r6 


0165 IF 

IHC 

R7 


0166 10 

IHC 

§R0 


0167 11 

IHC 

tel 


0168 08 

IHS 

A,BUS 

; 801^8 only 

0169 I 2 I+U 

JBO 

ADDR2 

;Not in 8022,8021 . 

oi6b 32k\ 

JBl 

ADDR2 

;Hot in 8022,8021 

oi 6 d 52 UU 

JB2 

ADDR2 

;Rot in 8022,8021 

OI 6 F 12kh 

JB3 

ADDR2 

;Not in 8022,8021 

0171 921^1+ 

jbU 

ADDR2 

;Hot in 8022,8021 

0173 B2Uit 

JB5 

ADDR2 

;Hot in 8022,8021 

0175 D2l^i^ 

JB6 

ADDR2 

;Hot in 8022,8021 

0177 F2kk 

JB7 

ADDR2 

;Hot in 8022,8021 

0179 F6l4lt 

JC 

ADDR2 


017B B6itU 

JPO 

ADDR2 

;Hot in 8022,8021 

017D 76 UI+ 

JFl 

ADDR2 

;Hot in 8022,8021 

017F 




017F 2i»2A 

JMP 

ADDRl 


0181 B3 

JMPP 

gA 


0182 E682 

ADDR3 : JHC 

ADDR3 


0l8i^ 8682 

JHI 

ADDR3 

; 801^8 only 

0186 2682 

JHTO 

ADDR3 

;Hot in 8021 

0188 h682 

JHTl 

ADDR3 


018A 9682 

JHZ 

ADDR3 


018C 1682 

JTF 

ADDR3 


018E 3682 

JTO 

ADDR3 

;Rot in 8021 

0190 5682 

JTl 

ADDR3 


0192 C682 

JZ 

ADDR3 
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W019l^ D682 
W 0196 8682 

0198 23TF 
019 A CT 
019B F 8 
019 c F9 
019D FA 
019E FB 
019F FC 
OlAO FD 
OlAl FE 
01A2 FF 
01A3 FO 
OlAlt FI 
01A5 h2 
01 A 6 DT 
WOIAT 90 

01A8 A8 
01A9 A9 
OLAA AA 
OlAB AB 
OlAC AC 
OlAD AD 
OlAE AE 
OlAF AF 

OIBO B 8 O 5 
01B2 B 905 
01B1+ BAO 5 
01 B 6 BB 05 
01B8 BCO 5 
OIBA BDO 5 
OIBC BEO 5 
OIBE BFO 5 

OICO AO 
OlCl A1 
01 C 2 BOO 5 
oicu B 105 
01 C 6 62 

OlCT OC 
01C8 OD 
01C9 OE 
OICA OF 


JBIBF ADDR3 

JOBF ADDR3 

MOV A,#7FH 

MOV A,PSW 

MOV A,RO 

MOV A,R1 

MOV A,R2 

MOV A,R3 

MOV A,Rlt 

MOV A,R5 

MOV a,r6 

MOV A,RT 

MOV A,§RO 

MOV A,§R1 

MOV A,T 

MOV PSW,A 

MOV STS, A 

MOV RO,A 

MOV R1,A 

MOV R2,A 

MOV R3,A 

MOV Rl|,A 

MOV R5,A 

MOV R6,A 

MOV R7,A 

MOV RO,#GRINCH 

MOV R1,#GRIHCH 

MOV R2,#GRINCH 

MOV R3,#GRI1}CH 

MOV RU,#GRINCH 

MOV R5,#GRINCH 

MOV R6,#GRINCH 

MOV R7,#GRINCH 

MOV §RO,A 

MOV eRl,A 

MOV eRO,#GRIHCH 

MOV §R1,#GRINCH 

MOV T,A 

MOVD A,PU 

MOVD A,P5 

MOVD A,P6 

MOVD A,P7 


;80Ul/ltlA only 
;80U1/1^1A only 

;Hot in 8022,8021 


;Hot in 8022,8021 
;80J+1A only 
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OICB 

3C 

MOVD 

OICC 

3D 

MOVD 

OICD 

3E 

MOVD 

OICE 

3F 

MOVD 

OICF 

A3 

MOVP 

OIDO 

E3 

M0VP3 

01D180 

MOVX 

011)2 

81 

MOVX 

01D3 

90 

MOVX 

OIBU 

91 

MOVX 

01D5 

00 

NOP 

0136 

1)8 

ORL 

01D7 

1)9 

ORL 

01D8 

1)A 

ORL 

011)9 

1)B 

ORL 

OIDA 

1)C 

ORL 

OIDB 

1)D 

ORL 

OlDC 

l^E 

ORL 

OIDD 

1+F 

ORL 

OIDE 

1)0 

ORL 

OIDF 

1)1 

ORL 

OlEO 

1)305 

ORL 

01E2 

881T 

ORL 

OlEl) 

8907 

ORL 

01E6 

8A07 

ORL 

01E8 

8C 

ORLD 

01E9 

8D 

ORLD 

OlEA 

8E 

ORLD 

OlEB 

8F 

ORLD 

WOIEC 

02 

OUT 

OlED 

02 

OUTL 

WOIEE 

90 

OUTL 

OlEF 

39 

OUTL 

OlFO 

3A 

OUTL 

WOIFI 

80 

RAD 

01F2 

83 

RET 

W01F3 

93 

RETI 

OlFl) 

93 

RETR 


Pl),A 


P5,A 


P6,A 


P7,A 


A,gA 


A.gA 

;Not in 8022, 8021 

.gRO 

;80l)8 only 

A.gRl 

; 801+8 only 

gROjA 

;80l)8 only 

gRl,A 

;80l)8 only 


A,RO 

A,R1 

A,R2 

A,R3 

A,Rl+ 

A,R5 

A,R6 

A,R7 

A,gRO 

A,gRl 

A,#GRINCH 

BUS,#17H 

;80l)8 only 

PI, #7 

;Not in 8022,8021 

P2,#7 

;Not in 8022,8021 

Pl),A 


P5,A 

P6,A 

n,A 

DBB,A 

;80ltl/UlA only 

BUS,A 

;80l)8 only 

PO,A 

;8021, 8022 only 

P1,A 

P2,A 

;8022 only 

;8022 only 
;Not in 8022,8021 
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F^e D-6 


01F5 E7 

RL 

A 

oif6 F7 

RLC 

A 

01F7 77 

RR 

A 

01F8 67 

RRC 

A 

W01F9 85 

SEL 

ANO 

WOIFA 95 

SEL 

ANl 

OlFB E5 

SEL 

MBO 

OlFC F5 

SEL 

MBl 

OlFD C5 

SEL 

RBO 

OlFE D5 

SEL 

RBI 

OlFF 65 

STOP 

TCNT 

0200 

STRT 

CNT 

0201 55 

STRT 

T 

0202 47 

SWAP 

A 

0203 28 

XCH 

A,R0 

0204 29 

XCH 

A,R1 

0205 2A 

XCH 

A,R2 

0206 2B 

XCH 

A,R3 

0207 2C 

XCH 

A,r4 

0208 2D 

XCH 

A,R5 

0209 2E 

XCH 

A,R6 

020A 2F 

XCH 

A,R7 

020B 20 

XCH 

A,§R0 

020C. 21 

XCH 

A,eRl 

020D 30 

XCHD 

A,eR0 

020E 31 

XCHD 

A,gRl. 

020F D8 

XEL 

A,R0 

0210 D9 

XRL 

A,R1 

0211 DA 

XRL 

A,R2 

0212 DB 

XRL 

A,R3 

0213 DC 

XRL 

A,R4 

0214 DD 

XRL 

A,R5 

0215 DE 

XRL 

A,R6 

0216 DF 

XRL 

A,R7 

0217 DO 

XRL 

a,€ro 

0218 D1 

XEL 

A,gRl 

0219 D305 

XRL 

A,#GRINCH 


,8022 only 
8022 only 
80lt8 only 
801^8 only 
Not in 8022,8021 
Not in 8022,8021 
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Contents Of The Diskette 


1 . XASM48 . COM 


8048/8041 Family Cross-Assembler 


2. TEST48.ASM Demonstration source code file, showing 

8048/8041 family instruction set. 


Current Versions 

Assembler: VI. 6 4 (Released 04-Oct-83) 

Manual ; Rev . 1.4 


Enhancements In VI. 64 


1. SYNONYMS FOR PSEUDO-OPS 

The pseudo-op EJECT has been added as a synonym for PAGE. 
INCLUDE has been added as a synonym for INCLUD. 


2. FORWARD REFERENCES IN PSEUDO-OPS 

An error will occur if a forward reference is present in the 
operand of any of the following pseudo-ops: 

DS 

EQU 

IF 

LOC 

ORG 

SET 

In general, if an 'F' error is present in your assembly you can expect 
obscure problems; usually, some symbols will have values which don’t 
correspond to the location counter. Thus, it's best to get rid of all 
illegal forward references before trusting the generated code. 


3. DEFAULT LISTING DESTINATION 

The assembly listing now defaults to a .PRN file, rather than to 
the printer. It may be diverted to the printer by specifying the 
'P* switch in the assembler command line. The 'D* switch is no 
longer recognized. 

Bugs Fixed In VI. 64 


1, The END statement is now recognized even if an unterminated conditional 
( ie . IF without ENDIF ) is present . 


48README/80 (04-10-84) 


Copyright (C) 1984, Avocet Systems, Inc. 
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2. When the assembly listing is sent directly to the printer^ the page 
headings no longer contain LF characters with the high-order bit set. 

3. The SHR operator has been fixed. 

4 . Symbols beginning with a period ( ” . ” ) are now accepted . 


Known Bugs Remaining In VI. 64 

1. The presence of a non-printing ASCII chaxacter in a source 
line may cause an 'S* error, or may cause the line to he 
interpreted incorrectly. 

2. Quasi-Bug; Assembler input (ie. source file) must be upper-case, 
except within quoted strings and character constants. 


Updates To XASM48 Manual 


1. FORMAT OF OBJECT FILE (Appendix B) 

The END record in object files produced by XASM48 is now: 


Byte 1 


: 

2. .3 

00 

(no. of data bytes) 

4. .7 

0000 

(or execution address, if 
specified in END statement) 

8. .9 

01 

( record type ) 

10 

FF 

( checksum ) 


This change reflects Intel’s revised definition of the HEX format. 


2. RE-DEFINITION OF HARDWARE REGISTERS (VI. 6 3 and Higher) 

By popular request, XASM48 now supports the assignment of symbolic 
names to the hardware registers. Thus one can write, for example. 


FOO 

EQU 

RO 

BAR 

EQU 

R5 


MOV 

A,@FO0 


MOV 

BAR,#27H 


3. INTERRUPTING ASSEMBLY 

Assembler operation may be terminated at any time by striking a control-C. 


48README/80 (04-10-84) 


Copyright (C) 1984, Avocet Systems, Inc. 
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Contents Of The Diskette 


1. XASM48.CMD (CP/M-86) .... 8048/8041 Family Cross-Assembler 

or 

XASM48.COM (MSDOS) 


2. TEST48.ASM Demonstration source code file, showing 

8048/8041 family instruction set. 


Current Versions 


CP/M-86: 1.64C, Released 20-Jul-83 
MSDOS (PCDOS); 1.64M, Released 20-Jul-83 
Manual : 1.4 


Known Bugs in Current Version 


1. The presence of a non-printing ASCII character in a source 
line may cause an *S' error, or may cause the line to be 
interpreted incorrectly. 

2. Forward references are not allowed in ORG, DS, IF, EQU, but 
are not flagged as errors if present. 

3. Quasi-Bug: Assembler input (ie. source file) must be upper-case. 


Updates To XASM48 Manual (Revision 1.4) 


1. ASSEMBLY LISTING DESTINATION (Section 2) 

The assembly listing now goes to a .PRN file (not to the printer) 
unless otherwise specified. The 'D* switch is no longer recognized. 
The *P* switch has been added. It causes the assembly listing to 
be sent to the printer. 


2. FORMAT OF OBJECT FILE (Appendix B) 

The END record in object files produced by XASM51 is now: 


Byte 1 


: 

2. .3 

00 

( no . of data bytes ) 

4. .7 

0000 

(or execution address, if 
specified in END statement) 

8. .9 

01 

( record type ) 

10 

FF 

( checksum ) 


This change reflects Intel's revised definition of the HEX format. 


48README/86 (04-10-84) Copyright (C) 1984, Avocet Systems, Inc. 
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3. RE-DEFINITION OF HARDWARE REGISTERS (General) 

By popular request, XASM48 now supports the assignment of symbolic 
names to the hardware registers. Thus one can write, for example, 

FOO EQU RO 

BAR EQU R5 

MOV A,@FOO 

MOV BAR,#27H 

4. INTERRUPTING ASSEMBLY 

Assembler operation may be terminated at any time by striking a control-C. 


48README/86 (04-10-84) 


Copyright (C) 1984, Avocet Systems, Inc. 
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Contents Of The Eiskette 


1. XASM48.CCM 6046/6041 Family Cross-Assembler 

2. TIST46.ASh Demonstration source code file, showing 

3048/6041 family instruction set. 


Current Versions 


CP/M-60: 1.64 (He leased 04-Cct-83) 


Inhancements Ir VI. 64 


1. SYNONYMS FOB PSFUTO-OFS 

The pseudo-op IJICT has teen added as a synonym for PAGi . 
INCLUIE has been added as a syncnym for INCLUD. 


FOPWAPP RfFFRFNC5,S IN FSPliEO-OFS 

An error will occur if a forward reference is present in the 

operand of any of the following pseudo-ops: 

rs 

F C'U 
IF 
LCC 
CFG 
SI T 

In general, if an 'F' error is present in your assemhly you can expert 
obscure problems; usually, some sym.bols will have values which don/t 
correspond to the location counter. Thus, it's best to rid of all 

illegal fcrward references before trusting the generated code. 


?. DEFAULT LISTING LISTINATICN 

The assembly listing now defaults to a .PPN file, rather than to 
the printer. It msay be diverted to the printer bp specifying tne 
' switch in the assembler command line. The 'B' switch is no 
longer recognized. 


Pugs Fired In VI .64 


1 . The FNL statement is new recognized even if an unterminated conditional 



(ie. li without INBII) is present. 


2. When the assemhly listiue is sent directly tc the printer, the page 
headings no longer contein LF characters with the high-order hit set. 

?. Ti^e SEh cperatcr has ceen fined. 

4. Synhols beginning with a period (”.") are now accepted. 


V, c wr. I ug s R e ra i n i ng In V 1 . 64 


The presence of a non-prir ting ASCII character in a source 
line may cause an error, cr may cause the line to ce 

interpreted incorrectly. 

Ouasi-Pug: Assemhler input (ie. source file) m^ust be upper-case, 
ercept within quoted strings and character constants. 


Updates Tc XASH48 Manuel 


1. FOEMAl OF OPJICT FILE (Appendix B ) 

The EhE record in object files produced by XASM48 Is now; 
E y tel ; 

2.. 3 00 (no. of data bytes) 

4.. 7 0000 (or execution address, if 

specified in ENL statement) 

8.. 9 01 (record type) 

10 if (checKsum) 


This chene-e reflects Intel's revised definition of the KhX format. 


2. PF-IEf IblTIOb OF HARL'WAEI EEGISTIRS (VI. 63 and Eigher) 

By popular request, XA3H48 new supports the assignment of symbolic 
names to tne hardware registers. Thus one can write, for example, 

ICO IQU R0 

lAP EQU E5 

MOV A,rcEOO 

MOV BAR,^27H 


3. INTIPEUPTING ASSEMILY 

Assembler operation may be terminated at any time by striking a control-C. 



